home *** CD-ROM | disk | FTP | other *** search
- 1-28-97 ************************************** 1-28-97
- | |
- | KGMD STEP BY STEP, EASY TO INSTALL |
- | K.ELLIS |
- | |
- **************************************
-
- =-=- FIRST -=-=
-
- (1) Get KEMD.ZIP, unzip it, then very carefully read all the texts BEFORE
- proceeding.
- (2) Get INSTFLPY.ZOO.
- (3) Get the whole folder BASIC.
- (4) Get the whole folder NET.
-
- *Note* if the link from my page is too slow to get the files with
- CAB/Lynx, try the direct Ftp address. Or try the ftp nic.funet.fi
-
- (5) Put all these files in one folder, called KEMD for instance.
-
- Thus it will be like:
-
- any GEMDOS (atari) partition\KEMD\basic.aaa
- basic.ab
- basic.ax
- net.aa
- net.ab
- net.ax
- instflpy.zoo
-
- (6) Now on C drive, or your boot drive, create a folder called multitos.
- (Leave it empty for now)
-
- (7) Unzoo the file INSTFLPY.ZOO in the folder KEMD with -e as parameter.
- (-e is to expand the archive).
-
- (8) Replace the files from the KEMD.ZIP into the main folder KEMD.
- Thus the files, SETUP, MINT.CNF, KGMD.TXT and README.NOW.
-
- (9) Make sure your boot was clean, meaning no extra auto programs or
- accessories loaded at boot time.
-
- (10) Run the program KGMDINST.TOS by double clicking on it.
- (A few questions will be asked)
-
- =-=- Questions Asked -=-=
-
- This is self explained, so no need to spend an hour on it.
-
- (*1) Hostname is just the name of your machine, call it whatever
- you like, "Falcon" or "Station1" for instance ... You choose..
-
- =-=- Next -=-=
-
- (1) Copy the correct MINT.PRG depending the machine you have from
- minix/boot to your boot partition (usually C) /auto.
-
- (2) Copy the content of the minix/boot/multitos folder into the
- /usr/multitos folder.
-
- (3) Rename the file MINTKGMD.CNF into MINT.CNF in the /usr/multitos
- folder.
-
- **NOTE** When I say MINIX, I mean the partition that KEMD would have
- created during the installation.
-
- (4) Now you can Reboot.
-
- (5) Check that MINT.PRG is at the end, in the auto folder.
- (use autosort.prg to resort your auto folder if you need)
-
- =-=- OPTIONAL: Installing an AES -=-=
-
- (1) Copy the AES on C. (to be more practical).
-
- (2) Edit the file C:\MULTITOS\MINT.CNF
- Add the lines SETENV AESDIR c:\your aes folder path.
- (not the executable, just the path.)
- Add all the other setenv that you know, for instance if you use the
- excellent desktop THING, you should add the line:
- setenv THINGDIR path of THING directory (not the executable again,
- just the directory where THING.APP is located)
-
- (3) You should add on to the line setenv PATH \bin;\usr\ucb these paths
- more, ;\sbin;\etc;\usr\sbin;\usr\local\sbin;\usr\local\bin
-
- (4) You might also want to remove the drive A from U drive by adding the
- line: ren u:\a u:\.a
- This will rename the drive a into .a , therefore U drive will not
- ask for a floppy everytime you open U drive.
-
- (5) Change the line cd u:\ by cd c:\
- and the line INIT has to be with regular partitions, not the minix
- one. For instance INIT=c:\multitos\init.prg instead of the u path.
-
- **NOTE**: save the files MINT.CNF with the standard IBM/ATARI standard
- (CR+LF). (from now on, for every UNIX files, you have to save the files
- without the CR, so find the option in your text editor where you can
- save in LF only(unix standard))
-
- (6) Edit the CNF file of your AES to set it up correctly, like some paths etc.
-
- (7) reboot with mint
-
- (8) edit the passwd file with vi editor: type vi /etc/passwd to do that.
-
- **NOTE** vi is a tricky text editor the first times you use it.
-
- (9) In this file change all the names tcsh or sh to bash. Bash would
- be easier to load the AES (windows style vs text based) the first
- couple of times.
-
- (10) Reboot again in Mint. (the changes you made will be effective that
- way)
-
- (11) To load the AES, be on the CONSOLE (alt F10), login as root and
- type the path+aes.sys (actually it could be any aes, n_aes.sys or
- gem.sys or whatever the aes you use)
-
- **NOTE** The aes is only loadable from the CONSOLE(alt f10).
-
- **NOTE** Your atari is separated into Virtual consoles and one main
- CONSOLE. The V.consoles are accessible by typing alt f1 to
- alt f9. The CONSOLE is on alt f10.
-
- If you didn't edit the /etc/ttytab file yet, you only have 2
- V.consoles available + the CONSOLE. You can change that to add
- more. Copy the driver you want from
- minix partition/boot/multitos into the bootdrive/multitos, for
- instance PPP requires the drivers socket.xdd and slip.xif. The
- driver minix.xdd being previously copied should stay there also.
-
- ** TIP **
-
- If you want to load the AES directly launchable from the login prompt
- in the console, add the following line in the file /etc/passwd.
- gem::0:0:The AES:/home/root:/full path of the aes with the executable.
-
- Thus, typing gem at the prompt as login it will load the aes
- automatically without even asking for a password.
-
- **NOTE** The AES user is considered as root and has the same power and
- privilege.
-
-
- =-=- OPTIONAL: How to setup PPP -=-=
-
- (1) From the folder /etc/ppp/samples, copy the file home-dot-ppprc into
- /home/root and rename it as .ppprc
-
- (2) Copy the file chat-script also into the folder /home/root and rename
- it .chat-script.
- (3) you have to change the protection of this file, type:
- chmod 600 .chat-script
-
- =-= Edit the file .ppprc to fit your setup =-=
-
- (A) You should change the modem port:
-
- -If you have your modem in the modem 1 port then the port would be from
- now on /dev/ttya
-
- -If you have your modem in the modem 2 port then the port would be from
- now on /dev/ttyb
-
- (B) Adjust the speed of your modem.
-
- (C) You need to call your internet provider and ask them for the MTU
- and MRU for your PPP account. Most of the time it will be 1500 or
- 1006. And most of the time MTU=MRU.
-
- If nothing else is added in this file, the default values would be
- MTU=MRU=1500.
-
- If you have a provider with values=1006 like me, you have to add the
- lines in the .ppprc file:
- MTU 1006
- MRU 1006
-
- **NOTE* The MTU value is not necessary the same if you connect as
- SLIP or PPP. So if you asked the MTU to your provider for SLIP, it
- could be a different number with PPP, ask them again,
- but now ask for PPP !!! ;)
-
-
- =-= Edit the file /home/root/.chat-script =-=
-
- (A) change the atd by your regular command that you type to connect to
- your provider.
- (For me it's ATDT354900 for instance)
- (This number is a telephone number by the way.. Just to make sure...)
-
- (B) Now the tricky part, try to know the login sequence and how to
- engage the PPP protocol.
-
- For me, I have to type my login name with a P in front of the login name
- to set the protocol to PPP, but some providers expect you to type PPP
- for protocol. Just use a terminal program, dial the telephone number and
- see how the provider login sequence works.
-
- **TIP**
-
- Don't enter the whole line expected. For instance, if your provider
- says login or password, don't use the whole name, just cut the start,
- otherwise it could not login correctly..
-
- for instance:
- ogin: your login name
- ssword: your password
- rotocol: PPP
-
- or another example,
-
- ame: your login name
- key: your key
- rotocol?: PPP
-
- or without the protocol line if it asks you to login as Plogin like
- I said.
-
- For example, mine is:
-
- ogin: Pkellis <- even if my login name is only kellis,
- the P means that it will start the
- session with PPP protocol
- ssword: my password
-
-
- =-= Setting up resolv.conf =-=
-
- (A) rename the file /etc/resolv.conf.sample as /etc/resolv.conf.
- In this file should go the domain name and their DNS number.
- you have to ask your provider for this.
-
- For instance, mine is: domain primenet.com
- nameserver 198.68.32.10
-
- **NOTE** You can NOT invent or create this number yourself!
- You have to ask your provider.
-
- (B) Rename the file /etc/domainname.sample to domainname.
-
- (C) Edit it and replace your domainname. it should be at the end of your
- email address most of the time.
-
- for me it should be primenet.com
-
- if your email address is joe@aol.com, then you should put aol.com as
- domainname.
-
- (D) Do a symbolic link from the V.console between /usr/etc/inetd and
- /etc/inetd by typing: ln -s /usr/etc/inetd /etc/inetd
-
- (E) Now, edit your /etc/rc.net.
- The two lines with ifconf and route add must be edited into that:
-
- ifconfig lo0 addr 127.0.0.0 up
- route add 127.0.0.1 lo0
-
- leave the rest like it is.
- ( for some reason, KGMD switched the 2 addresses)
-
- =-= Checking to see if PPPD is working =-=
-
- (*) (re)boot into mint,
-
- (A) login as root in a V.console ( alt F1 for instance).
-
- (B) Type pppd
-
- (C) See if the modem connects or not.. (pppd is a program, the dialer
- for PPP actually.)
-
- (D) if it connects, look into the CONSOLE (alt F10) to see the log
- sequence. If it is successful, it should give you 2 different
- addresses, local and remote..:)
-
- **NOTE**: The log file for the PPP connection is in /var/log, like
- that you can trace the history of your PPP connection.
-
- (E) Edit the file /etc/hosts
-
- It should be: 127.0.0.0 localhost loopback lo0 loghost
- 127.0.0.1 hostname
-
- (the hostname being the hostname you took before, Falcon for me or
- Station1 or whatever you took, see (**NOTE**)) so replace the hostname
- there by the one you chose.
-
-
- =-=- How do I know if my setup works? -=-=
-
- 1) try to ftp from the Vconsole 1 (alt f1).
-
- to do that, type: ftp ftp.cnam.fr and see if it does anything..
-
- login : anonymous
- password: your email address.
-
- (A) if that works you can go into the directory /pub/Atari and get cool
- software for the internet, irc II, gopher, lynx Aftp in GEM, etc etc..
-
- (B) if it doesn't work, you'll have to mess with the files more..:(
-
- (2) try to type: finger your email address and see what it says..
-
-
- *=-=- Troubleshooting -=-=*
-
- (P) The modem won't even dial
-
- (A1) reboot again without hsmodem and see if it's better.
- if HSmodem was the problem then you need to find the good order
- in the auto folder.
-
- (A2) try to see if the modem itself is well configured..
- By typing at&v in a terminal program like ConNect or Stalker, it
- should give you all the information about your modem. Check with
- your modem manual.
-
- (P) Everything is fine but I can not use ConNect or stalker with mint..:(
- what should I do?
-
- (A) Well, the ports are redirected with mint from the boot
- partition:\multitos\mint.cnf file, with the command ren modem2 ttyb
- for instance. Let say that conNect really wants to see the modem2
- available to be able to work, then just don't use the command ren
- that will rename it totally, but replace it by sln instead, like
- that it will create a link between modem2 and ttyb, thus keeping
- the modem2 available and ttyb that mintnet needs.
-
- (P) KGMDINST.TOS locks up when creating a minix partition
-
- (A1) If it locks up in the middle, I've found that it seems to trash
- the partition. Though this is not the case all the time. If it is,
- It has to be rebuilt (ICD's ICDFMT.PRG for instance)
-
- (A2) If you are creating a minix partition over an already exhisting
- minix partition and it gives you /minix/: permission denied, then
- you will also have to rebuild the partition before attempting to
- install again. (This will be listed with it displays the partition
- contents to you)
-
- ***NOTE*** Rebuilding the partition. I use ICD PRO's ICDFMT.PRG to do
- this myself. Basically, you have to find a way to turn it back into a
- GEM/BGM partition (with completely rebuilding the FAT, etc)
-
-
- =-=- UPGRADE -=-=
-
- Now, Mintnet should be installed... but only version 0.7.
- You might need to upgrade it. (recommended actually)
-
- (1) Replace the file PPPD in the folder /usr/etc by the new one given
- with this doc.. (pppd = dialer)
-
- (2) Replace the new slip and socket files given with this doc
- in the folder c:/multitos .
-
- Here you go, mintnet 1.01 is installed now. :)
-
-
- =-=- MISC -=-=
-
- ***NOTE***
- If you want to use CAB or the other STIK prg, just get GLUESTIK and
- install it. Programs like Duftp or Aftp don't require Gluestik, by the
- way.
-
- ** TIP **
- If you want to bypass the filesystem check at bootup to gain speed,
- you can do it by adding the line: touch /etc/fastboot in the
- file /etc/rc.local and reboot twice (or if you can create a null file
- fastboot in the folder /etc then you just need to reboot once, but still
- the line touch in /etc/local.rc is needed.)
-
- *NOTE* The command touch filename, create an empty file like mkdir
- would create a folder.
-
- At the boot up sequence, the system looks for a file called fastboot
- in the folder /etc. If it finds it, it will bybass a lot of tests.
-
- **NOTE** the mint.cnf given with the KEMD package is only meant to be used
- by the INSTALL.TOS prg..
- **NOTE** on a machine <4 meg of RAM, try to avoid things like NVDI and
- big accessories.
-
- =-=- A few commands in the UNIX world -=-=
-
- - The TAB key is an automatic completion.
- if you type for instance cd /etc/ali [press TAB key]
- It will complete the ali by aliases. Try it you'll understand.
- -cd to change directory.
- cd .. to go up in the tree.
- cd / will go at the root of your unix partition..
- so for instance if you are in the directory u:/usr/local/bin/ and you
- want to go in the directory u:/bin just instead of having to go up in
- the tree by typing cd .. cd .. etc, just type cd /bin
- test it you'll understand...
-
- -ls to display what's in the folder.
- like the command dir under MSDOS.
-
- -cp is to copy a file, just use it like that:
- cp path+filename source path+filename destination
- for instance: cp text.txt /usr/local/text.txt
-
- -mv is to move files, used like cp.
-
- -chmod xxx filename is to change the protection level of a certain file or folder
-
- -ln -s path\file1 path\file2 is used to make a symbolic link.
- It will copy the file at the other path without taking the same
- amount of hard drive space :) thus you can have a 1 meg prg linked
- everywhere on your hard drive and still take a very small amount of disk space..
- Very useful.
-
- -free to see the memory (RAM) and the block of free RAM.
-
- -ps to see the prg installed (the PID,STATUS, Size, time, name etc..
-
- -kill pid will terminate/kill/exit the prg associated with the pid read
- with ps. for instance kill 68 , if 68 is the PID associated with the
- control panel then it will close this accessory.
-
- -top to see the presently running programs in real time.
-
- -rm filename to delete a file.
-
- -rm -r folder to delete a folder.
-
- -vi filename to call the vi text editor with the filename as file to edit
- or create.
-
- -gunzip filename.tgz to unzip a tgz file. The result would be
- filename.tar
-
- -tar -xvf filename.tar to untar the tar archive..Thus to have the
- original files.
-
- **NOTE** For the other commands you should open the /bin folder and see what are
- the prg and try them or with --help as parameter. For instance ls is
- more powerful then we could imagine, type ls --help to see the help
- associated with it.. For the other commands, a unix manual would also
- be helpful.
-
- Any comments to kellis@primenet.com
-
- Personnal thanks to the author of KGMD, SWE, LP, Matrixx and the others on
- IRC.
-
-